home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 4 / United Public Domain Gold 4.iso / tbag / tb065.dms / tb065.adf / Docs / RoxBlanker.docs < prev    next >
Text File  |  1992-03-15  |  4KB  |  113 lines
  1.  
  2. ----------------------------------------------------------------
  3. RoxBlanker II -- Copyright 1992 Joe Hitchens All Rights Reserved
  4. ----------------------------------------------------------------
  5.  
  6. ----------------------------------------------------------------
  7. This software package and all files and data included with it
  8. is/are copyrighted material. Nothing contained herein may be
  9. reproduced or distributed without the express written consent of
  10. the copyright holders except for the following special case;
  11. Permission is hereby given by the copyright holder(s) to
  12. distribute copies of this software package provided that the
  13. copies distributed are in exactly the same form as originally
  14. received and provided that no net profit or gain of any kind is
  15. made by any party involved in the transaction.
  16. ----------------------------------------------------------------
  17.  
  18.  
  19.  
  20.  
  21.  
  22. ----------------------------------------------------------------
  23. RoxBlanker II -- Documentation
  24. ----------------------------------------------------------------
  25.  
  26. Author  : Joe Hitchens
  27. Created : December 11, 1991 (or thereabouts)
  28.  
  29. RoxBlanker II is a fancy screenblanker program. It blanks the
  30. screen by running animation files which were created with a
  31. program called Roxanne. It is based on the original RoxBlanker
  32. which was launched by SleepyCron at idle time. This version is
  33. a standalone version that does not require SleepyCron.
  34. But get SleepyCron anyway, because it's way cool.
  35.  
  36.  
  37. RoxBlanker should be run by your startup-sequence something like this:
  38.  
  39.      cd roxfiles:
  40.      run >nil: roxblanker file1.rox file2.rox file3.rox (etc.)
  41.  
  42. When the system becomes idle (about 4 minutes of inactivity), one of the
  43. .rox files given on the command line will be picked at random and
  44. animated as a screenblanker.
  45.  
  46. To make RoxBlanker exit, you must ^D or ^C it.  You may have to
  47. use the 'break' command to do this.  See your Amiga documentation
  48. on how to use the CLI 'break' command.
  49.  
  50. To force the program to blank immediately, use 'break e'.
  51. This is useful for testing the blanker to make sure it can
  52. load all of the .rox files you gave it ... just do this:
  53.  
  54.     1> roxblanker file1.rox file2.rox (etc.)
  55.  
  56. Note that 'run' was not used. Type ^E to cause a blank over
  57. and over until you are sure you have seen all the .rox files.
  58. Then you can run it in the background from the startup-sequence
  59. normally.
  60.  
  61. RoxBlanker will stop blanking when the mouse is moved or a
  62. key is pressed.
  63.  
  64. Remember, the .rox files have to be specified with an absolute
  65. path, that's why you need to 'cd' to the directory ... so you don't
  66. have to type dh0:dir1/stuff/roxfiles/roxfile1.rox for every argument.
  67.  
  68. RoxBlanker DOES use up a certain amount of chip ram when it
  69. blanks.  It opens an intuition screen of up to 5 bitplanes (I don't
  70. think any of the .rox files here are more than 3) and 2 more bitmaps
  71. of equal size to the first screen (for double buffering).
  72. So if you are tight on memory, RoxBlanker could have trouble
  73. blanking.  If your machine always has very little free memory
  74. available, RoxBlanker may not work out for you.
  75.  
  76. I plan to make it possible for RoxBlanker to blank the screen with
  77. NO additional memory so that if it DOES have trouble running the
  78. Roxanne animation it will still blank.
  79. There is not yet any control of the idle time, or input handler
  80. priority, or wild cards for specifying many .rox files.
  81. Register your copy of RoxBlanker according to the shareware
  82. information provided to let me know if you think these
  83. (or other things) are important to you.
  84.  
  85. How to reach me by mail:
  86.  
  87.   Joe Hitchens
  88.   45 North Main
  89.   North Salt Lake, UT  84054
  90.  
  91. How to reach me by phone:
  92.  
  93.   (801) 359-5514  or
  94.   (801) 292-2190
  95.  
  96. How to reach me by email:
  97.  
  98.   jhitchen@magna.math.utah.edu
  99.   or
  100.   joe@vixen.uucp
  101.   or
  102.   joe@olga.uucp
  103.   or
  104.   ...!uunet!iconsys!caeco!olga!joe
  105.  
  106.  
  107.  
  108.  
  109. j.h.
  110. February 7, 1992
  111.  
  112.  
  113.